gh-85989: deprecate float.__getformat__() class method - #146400

CC @serhiy-storchaka

@vstinner, please don't merge. I would appreciate a second review.

in general, I like removing private, unsystematic, undocumented methods which only serve internal debugging purpose. There some things in bytearray and set. But first we need to look at their history and ask authors who added them. Do they still need them? I think that special testing module would be better place for such things.

But first we need to look at their history and ask authors who added them. Do they still need them?

The __getformat__() class method, together with removed __setformat__() was added by ba283e2. CC @mwhudson

I think that special testing module would be better place for such things.

This private API now is helpful only for alternative implementations, which run the CPython test suite. I don't see how a special testing module would help here.

See #145633 (comment) for some usage examples.

But first we need to look at their history and ask authors who added them. Do they still need them?

The __getformat__() class method, together with removed __setformat__() was added by ba283e2. CC @mwhudson

Oh dear me that was nearly 21 years ago! Unsurprisingly the details have faded a bit but I'm pretty sure this was around making struct.{pack,unpack} work with NaNs and infs and such. If Python requires IEEE 754 to build then I think it can all be regarded as historical fluff and deprecated then deleted.

If Python requires IEEE 754 to build then I think it can all be regarded as historical fluff and deprecated then deleted.

The problem is that the CPython test suite used in alternative implementations, like PyPy. In principle they may not require IEEE-compatible formats for floats.

That's why @mdickinson suggested to keep requires_IEEE_754 decorator. Which, in turn, needs something to check that this requirement is satisfied. New helper does same checks as before, if ctypes module is available.

Don't close, just open a discussion on https://discuss.python.org/, wait a week

See https://discuss.python.org/t/deprecate-float-getformat/107151.

Sadly, this couldn't enter v3.15.

Documentation build overview

📚 cpython-previews | 🛠️ Build #33905793 | 📁 Comparing 2c55ab2 against main (2a07ff9)

  🔍 Preview build  

then we will see if there are any serious ideas or arguments for or against the deprecation.

I think there aren't, no?

The sys.float_info also restricts it's scope to the float.h header. Lets not break it without good reasons. The C standard now have DBL_IS_IEC_60559 flag here, but it doesn't indicate something like conformance to the IEEE 754 double format. We can expose this, but I doubt it's a replacement for the current test.